home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / cdity / MultiCX148.lha / MultiCX.doc < prev    next >
Text File  |  1995-01-20  |  12KB  |  340 lines
  1. ------------------------------------------------------------------------
  2.                          MultiCX 1.48 (20.1.95)
  3. ------------------------------------------------------------------------
  4.  
  5. MultiCX  is the smallest Multi-Function-Commodity for the Amiga, thought
  6. as  a  replacement  for  many  larger  and  sometimes  badly  programmed
  7. programs.  It is a 100% pure commodity, which means that it does not use
  8. any  patches (SetFunction), no interrupts and no special input handlers.
  9. So it can safely be disabled or removed at any time.
  10.  
  11. ------------------------------------------------------------------------
  12.                                 Features
  13. ------------------------------------------------------------------------
  14.  
  15. - Notification
  16.  
  17.   MultiCX  recognizes  any  changes  of  the ToolTypes while running, so
  18.   there's no real need for a GUI.
  19.  
  20. - Screen Blanker
  21.  
  22.   MultiCX  includes  a  simple but compatible screen blanker.  It always
  23.   uses  the  display  mode  which  fits best to the actual front screen,
  24.   while taking the lowest resolution with only one plane.
  25.  
  26.   ToolTypes:
  27.  
  28.   SCRBLANK=n            sets number of seconds until screen blanks,
  29.                         0 means OFF
  30.   HOTBLANK=Qual&Key     sets hotkey for immediate blanking
  31.   LIKEWB                forces cloning the WB's display mode
  32.  
  33. - Mouse Accelerator
  34.  
  35.   MultiCX  lets  you  set Acceleration and Theshold (minimum movement to
  36.   activate Acceleration) for smooth mouse handling.
  37.  
  38.   ToolTypes:
  39.  
  40.   ACCELERATION=n        sets Acceleration factor, 0 means OFF
  41.   THRESHOLD=n           sets Threshold value, 0 means no Threshold
  42.  
  43. - Mouse Blanker
  44.  
  45.   MultiCX  blanks the mouse pointer on keypress and/or after approx.  30
  46.   seconds when no mouse movement has occured.
  47.  
  48.   ToolTypes:
  49.  
  50.   KEYBLANK              activates MouseBlanking on keypress
  51.   TIMEBLANK             activates MouseBlanking after timeout
  52.  
  53. - Screen Cycle
  54.  
  55.   MultiCX  allows you to cycle screens using either MiddleMouseButton or
  56.   BothMouseButtons, this is equivalent to LCOMMAND M.
  57.  
  58.   ToolTypes:
  59.  
  60.   SCRCYCLE=MMB|BMB      sets Screen Cycle to MMB or BMB
  61.  
  62. - Mouse Shift
  63.  
  64.   MultiCX  lets  you  use the RightMouseButton or MiddleMouseButton as a
  65.   Shift-Key for extended selection.
  66.  
  67.   And this is how it works with RightMouseButton:
  68.  
  69.   1. Press LeftButton to select first icon and hold it.
  70.   2. Press RightButton and hold it.
  71.   3. Release LeftButton and keep RightButton pressed.
  72.   4. Now select some more icons with LeftButton.
  73.   5. To deselect an icon, click on it with LeftButton and keep it
  74.      pressed, then release RightButton and press it again.
  75.  
  76.   Sounds much more complicated than it is...
  77.  
  78.   If  MOUSESHIFT  and SCRCYCLE are set to MMB, then MouseShift will stay
  79.   inactive.
  80.  
  81.   ToolTypes:
  82.  
  83.   MOUSESHIFT=RMB|MMB    sets MouseShift to RMB or MMB
  84.  
  85. - Window Cycle
  86.  
  87.   MultiCX  lets  you put a window to front/back by a configurable number
  88.   of LeftButton clicks. Qualifiers can be defined for both functions.
  89.  
  90.   ToolTypes:
  91.  
  92.   WINCYCLE=n            sets number of clicks for WindowCycle,
  93.                         0 means OFF
  94.   WINFRONTQUAL=Qual     sets Qualifier for WindowToFront
  95.   WINBACKQUAL=Qual      sets Qualifier for WindowToBack
  96.  
  97. - SUN-alike Window Activation
  98.  
  99.   MultiCX has three different options to activate windows automatically.
  100.   All  of  them activate the window under the mouse pointer, SunKey does
  101.   it  on  every  keypress,  SunMouse  does  it after mouse movement, and
  102.   SunRMB  does  it after pressing the right mouse button.  So SunKey and
  103.   SunMouse together seem to be rather useless.
  104.   Windows  with  active Gadgets  (like FileRequesters etc) will never be
  105.   deactivated by one of these functions.
  106.  
  107.   ToolTypes:
  108.  
  109.   SUNKEY                activates SunKey
  110.   SUNMOUSE              activates SunMouse
  111.   SUNRMB                activates SunRMB
  112.  
  113. - HoldX and HoldY
  114.  
  115.   MultiCX  allows you to lock a specific mouse dimension while holding a
  116.   defined Qualifier. If both Qualifiers are set to the same it locks all
  117.   mouse movements. So you are responsible for useful settings...
  118.  
  119.   ToolTypes:
  120.  
  121.   HOLDXQUAL=Qual        sets Qualifier for HoldX, none means OFF
  122.   HOLDYQUAL=Qual        sets Qualifier for HoldY, none means OFF
  123.  
  124. - Enter ASCII
  125.  
  126.   MultiCX  allows  you to enter ASCII codes directly by pressing the ALT
  127.   key  and the  numbers in the numeric block, for example: <ALT> 65 = A.
  128.   Maximum 3 digits, value must not be greater than 255.
  129.  
  130.   ToolTypes:
  131.  
  132.   ENTERASCII            activates EnterASCII
  133.  
  134. - CapShift
  135.  
  136.   This  option  changes  the  way  CapsLock  works.  Just try activating
  137.   CapsLock,  and  then  press some shifted letters to get an idea of it.
  138.   Hotkeys etc. are no longer affected by CapsLock.
  139.  
  140.   ToolTypes:
  141.  
  142.   CAPSHIFT              activates CapShift
  143.  
  144. - Window Close/Zoom
  145.  
  146.   MultiCX  allows you to close/zoom windows using pre-defined Qualifiers
  147.   and Keys.
  148.  
  149.   ToolTypes:
  150.  
  151.   WINCLOSE=Qual&Key     sets Qualifier and Key for CloseWindow,
  152.                         none means OFF
  153.   WINZOOM=Qual&Key      sets Qualifier and Key for ZoomWindow,
  154.                         none means OFF
  155.  
  156. - Window Remember
  157.  
  158.   MultiCX remembers the last active window on every screen, and the next
  159.   time  you  go  to  that  screen,  this  window  will  be  re-activated
  160.   automatically.
  161.  
  162.   ToolTypes:
  163.  
  164.   WINREMEMBER           activates WindowRemember
  165.  
  166. - PopCLI
  167.  
  168.   MultiCX  spawns  a  UserShell  using  the  given  command  string when
  169.   pressing  the  PopCLI  key.  Optionally the Workbench may be popped to
  170.   front first.
  171.  
  172.   ToolTypes:
  173.  
  174.   POPCLI=Qual&Key       sets Qualifier & Key for PopCLI, none means OFF
  175.   POPCLICMD=Command     sets command string for PopCLI, none means OFF
  176.   POPCLISTACK=n         sets stacksize for PopCLI (Default: 4096)
  177.   WBTOFRONT             activates WBToFront for PopCLI
  178.  
  179. - System Flags
  180.  
  181.   MultiCX lets you set/change some of the internal AmigaOS flags.  These
  182.   may  be  set,  unset  or  left unchanged, where a parameter of 0 means
  183.   deactivate, 1 or any value >0 means activate, and putting the ToolType
  184.   in brackets (the same as removing it) means no change.  Old values are
  185.   NOT  restored when quitting/disabling MultiCX, but Notification may be
  186.   used at any time.
  187.  
  188.   ToolTypes:
  189.  
  190.   BLACKBORDER=n         changes BlackBorder flag, ECS Denise needed
  191.   NOCLICK=n             changes NoClick flag for all drives,
  192.                         may not work with very old drives
  193.   WILDSTAR=n            changes flag for extended WildCarding,
  194.                         if ON "*" may be used instead of "#?"
  195.  
  196. ------------------------------------------------------------------------
  197.                             Notes and Hints
  198. ------------------------------------------------------------------------
  199.  
  200. - MultiCX must be started from WB, CLI/Shell is not supported.
  201.  
  202. - MultiCX  is  100%  compatible to Commodore's  specifications, so don't
  203.   complain if some bad-behaving software does not work with it.
  204.  
  205. - MultiCX's  Screen  Blanker  uses  BestModeID to find  the best display
  206.   mode.   Because  this is impossible under AmigaOS 2.x,  MultiCX uses a
  207.   special masking algorythm to find the display mode. But this relies on
  208.   the fact, that a DisplayID with all ModeKeys set to 0 exists.
  209.   Anyway you should use AmigaOS 3.x for best results.
  210.  
  211. - BlackBorder is not fully supported by AmigaOS 2.x, but should work.
  212.  
  213. - Some very old drives do not like NoClick,  so switch it off at once if
  214.   your drive makes funny noises...
  215.  
  216. - If  you  like to toggle some of MultiCX's features using  hotkeys, you
  217.   should try ToolManager 2.1 (by Stefan Becker) together with DoIcon (by
  218.   Lars Eilebrecht).
  219.  
  220. - MultiCX  may  be  enabled, disabled or removed  from within scripts by
  221.   using HandleCX (included in this archive).
  222.  
  223. ------------------------------------------------------------------------
  224.                                 History
  225. ------------------------------------------------------------------------
  226.  
  227. 1.00 - 1.20     internal Beta releases
  228.  
  229.        1.21     first public release
  230.  
  231.        1.22     - Keyboard Mouse works with SUNKEY now
  232.                 - SCRBLANK uses Standard Monitor now if BestModeID could
  233.                   not find a valid ScreenMode
  234.  
  235.        1.23     - improved MOUSESHIFT and MMBCYCLE, see details above
  236.  
  237.        1.24     - removed little bug in new MMBCYCLE
  238.  
  239.        1.25     - improved SCRBLANK under AmigaOS 2.x
  240.  
  241.        1.30     - Signal/Message system completely rewritten to prevent
  242.                   deadlock situations
  243.                 - improved WINREMEMBER
  244.                 - created seperate version for OS 3.x only with reduced
  245.                   code overhead
  246.  
  247.        1.31     - improved WINCYCLE and SUN-functions
  248.  
  249.        1.32     - improved Signal/Message system and asynchronous design
  250.                 - improved documentation
  251.                   (Special thanks go to John C. Davis for his help)
  252.  
  253.        1.33     - removed some more deadlock candidates
  254.  
  255.        1.34     - removed a small message handling bug
  256.  
  257.        1.35     - fixed stupid bug in WINCYCLE (I hate those typos...)
  258.  
  259.        1.36     - fixed problem in WINREMEMBER which could cause
  260.                   Enforcer hits under some very special conditions
  261.  
  262.        1.37     - improved AutoRepeat behaviour
  263.  
  264.        1.40     - Exchange's "Show Interface" or HandleCX's "POPUP"
  265.                   will open WB Icons/Information now (OS 3.x only!)
  266.                 - fixed bug in SCRBLANK
  267.  
  268.        1.41     - implemented CX_POPKEY feature (OS 3.x only!)
  269.                 - MultiCX opens WBInfo now if it is already running
  270.                   and started again (OS 3.x only!)
  271.  
  272.        1.42     - POPCLI Shell gets full path now (what a bad hack...;-)
  273.                 - SCRBLANK, WINCYCLE, ACCELERATION and THRESHOLD no
  274.                   longer accept negative values
  275.  
  276.        1.45     - improved handling of windows with active menu
  277.                 - implemented timeout for re-blanking of screen
  278.                 - screen will be unblanked when disk is inserted
  279.                 - Mouse Blanker is more compatible to (bad) graphics
  280.                   boards now
  281.                 - implemented POPCLISTACK ToolType
  282.                 - MMBCYCLE changed to SCRCYCLE, see details above
  283.                 - improved MOUSESHIFT, see details above
  284.  
  285.        1.46     - deselecting an icon now works with MOUSESHIFT=MMB,
  286.                   just keep LButton pressed while releasing MButton
  287.                   for a short while
  288.  
  289.        1.47     - Mouse Blanker changed back to old routine, because
  290.                   some gfx board drivers seem to have even more problems
  291.                   with ss_height > 0
  292.                 - implemented HOTBLANK and LIKEWB features
  293.  
  294.        1.48     - improved ENTERASCII slightly
  295.  
  296.  
  297. ------------------------------------------------------------------------
  298.                                  Author
  299. ------------------------------------------------------------------------
  300.  
  301.  
  302.                              Martin Berndt
  303.  
  304.                           Fr.-Alfred-Str. 115
  305.                              47226 Duisburg
  306.  
  307.                                 Germany
  308.  
  309.                E-Mail Germany: m_berndt@wanderer.dssd.sub.org
  310.          E-Mail International: m_berndt@wanderer.gun.de
  311.  
  312.  
  313. ------------------------------------------------------------------------
  314.                               Legal Stuff
  315. ------------------------------------------------------------------------
  316.  
  317. MultiCX  is  GIFTWARE,  so simply send me anything you like.
  318. Gold bars, Ferraris and programming jobs in the US are prefered...   ;-)
  319.  
  320. Copyright
  321. ---------
  322. MultiCX is written and copyright © 1994-1995 by Martin Berndt.  No parts
  323. of  this  program  may  be  altered by any means (this includes editing,
  324. reprogramming, crunching, resourceing etc.), except archiving.
  325.  
  326. Disclaimer
  327. ----------
  328. The  author  is in no way liable for any changes made to any part of the
  329. program,  or  consequences thereof as he is in no way liable for damages
  330. or loss of data directly or indirectly caused by this software.
  331.  
  332. Distribution
  333. ------------
  334. Neither fees may be charged nor profits may be made by distributing this
  335. piece  of  software.  Only a nominal fee for costs of magnetic media may
  336. be  accepted,  the  amount  of  US  $5  shouldn't be exceeded for a disk
  337. containing  MultiCX.  CD Manufactures are specifically granted the right
  338. to  include  this program on CD collections, as long as they are for the
  339. Public Domain.
  340.